home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / print / dj2side.arj / DJ2SIDE.TXT < prev    next >
Text File  |  1993-02-04  |  13KB  |  370 lines
  1.  
  2.  
  3.                            DJ2SIDE.EXE
  4.                     Copyright 1993 Warrick Wilson
  5.  
  6.  
  7. Features
  8. ~~~~~~~~
  9.  
  10. - two-sided printing on your DeskJet printer
  11. - offset pages to allow for three-hole punching - great for
  12.   documentation that comes with shareware (like this file!)
  13. - automatic recognition of paginated documents (containing
  14.   formfeed characters)
  15. - user-specified header, footer and line widths for printing files
  16.   without formfeeds
  17. - select either LPT1, LPT2, or LPT3
  18.  
  19. System Requirements
  20. ~~~~~~~~~~~~~~~~~~~
  21.  
  22. DJ2SIDE will work with any DOS system and DeskJet printer.  You
  23. need at least one and a half times as much disk space as the file
  24. you are printing occupies.  (e.g. a 100K file needs another 150K or
  25. so to print)
  26.  
  27.  
  28. Licensing
  29. ~~~~~~~~~
  30.  
  31.         The programs and documentation in this archive are
  32.             Copyright (c) 1993 by Warrick Wilson
  33.  
  34. DJ2SIDE is a shareware utility. This means that you only pay for it
  35. if you decide to continue using it.  If you don't think that it is
  36. worth the asking price, delete the program, or better yet give it to
  37. someone who might find it useful.  However if you do decide to keep
  38. DJ2SIDE after a 2 week trial period, please send a cheque for the
  39. appropriate registration amount (see REGISTRATION FORM on next page)
  40. to:
  41.  
  42.            Warrick Wilson
  43.            98 Nipigon Street
  44.            Kitchener, Ontario
  45.            Canada  N2B 3N7
  46.            519-571-1690
  47.  
  48. The shareware fee pays for unlimited use of DJ2SIDE by a single
  49. person.  You are allowed (and encouraged) to give away copies of
  50. DJ2SIDE with the understanding that each person receiving a copy is
  51. under the same obligation as you are to send in the shareware fee if
  52. they decide to keep it.  You can upload DJ2SIDE to other computer 
  53. systems, either free or commercial, as long as this archive remains 
  54. intact, with the copyright and shareware notices unchanged.
  55.  
  56. No guarantee is made as to the functionality of this software;
  57. however it has been tested as thoroughly as possible.  If it doesn't
  58. do what you want, don't keep it and send no money.  If you do find a
  59. problem, I'd appreciate hearing about it.
  60.  
  61. Please support the shareware concept.  Shareware means useful
  62. programs at a fraction of the cost you might pay for them
  63. commercially.  You can try-before-you-buy, and you are not subjected 
  64. to copy protection or other atrocities that many software vendors 
  65. inflict on their customers.  Software updates can also be distributed 
  66. much faster than is possible through normal channels.
  67.  
  68. Any questions, suggestions, or bug reports, can be mailed to the
  69. above address.  It's my home phone number, so you can call, but
  70. please call between 6 p.m. and 9 p.m. Eastern time.  There's usually
  71. an answering machine on during the day, so you can leave a message.
  72.  
  73. Enjoy,
  74.  
  75. Warrick Wilson
  76.  
  77.  
  78. What does DJ2SIDE do?
  79. ~~~~~~~~~~~~~~~~~~~~~
  80.  
  81. I got fed up with printing all my documents on one side of the page.  
  82. Not only does it cost a lot for the paper, but you have to store the 
  83. output somewhere!  I figured that if I could print on both sides, 
  84. I'd save space as well as money.
  85.  
  86. DJ2SIDE is the result.  It prints text files, using an HP DeskJet, on
  87. both sides of the page.  It tries to figure out whether the file
  88. already has formfeeds delimiting the pages.  If it finds formfeeds in
  89. a document, it just sends that document to the printer.  If there are
  90. no formfeeds, then DJ2SIDE will paginate the document for you.
  91.  
  92. Most shareware text files (like this one) don't have enough space at
  93. the left side of the page for three-hole punching.  DJ2SIDE lets you
  94. add spaces to the front of the line on facing (odd) pages for this
  95. purpose.
  96.  
  97. The other neat thing that DJ2SIDE does is print the pages out in
  98. reverse order, so that the first page of the first document you
  99. specified ends up on top.  No more DeskJet Output Shuffle!!
  100.  
  101. DJ2SIDE attempts to monitor the printer status to recognize paper out
  102. and offline conditions.  I've done the best I can do, but I suppose
  103. this area oculd be improved if people recognize a need.
  104.  
  105.  
  106. What Doesn't DJ2SIDE do?
  107. ~~~~~~~~~~~~~~~~~~~~~~~~
  108.  
  109. DJ2SIDE is NOT an editor, a word processor, or a pretty printer.  It
  110. just takes the documents you specify and tries to print them on both
  111. sides of the page.  It will no reformat paragraphs, number pages,
  112. adjust your printer settings, or do any of that other fancy stuff.
  113. At least, not now.  Given enough requests for this type of facility, 
  114. I could always add it in.  I haven't really needed it so far, which 
  115. is why that feature isn't in.  If you really want it, let me know.  
  116. Even better, register your copy and include your request in with 
  117. your registration!
  118.  
  119. DJ2SIDE has no way of printing a subset of a document.  That is a 
  120. future plan.  I'll implement that once I notice a lot of problems in 
  121. printing documents out, or when I get a lot of requests for it.
  122.  
  123.  
  124. DJ2SIDE Overview
  125. ~~~~~~~~~~~~~~~~
  126.  
  127. DJ2SIDE takes some (optional) control parameters and a list of 
  128. documents to be printed.  You should first set up your printer in 
  129. any particular printing mode (e.g. condensed print) before running 
  130. the program.  Once the program is running, DJ2SIDE displays the 
  131. current document being processed, and a running total of the number 
  132. of pages processed and the number of physical pages of output that
  133. will be produced.
  134.  
  135. DJ2SIDE creates some temporary files on your disk.  You need about
  136. one and one-half times extra space above the total space taken by
  137. your documents.  If you specify 100K of documents to print, you need
  138. about 150K free disk space.  DJ2SIDE makes files of the "fronts" and
  139. "backs" of the pages to print.
  140.  
  141. Once all the documents have been processed, DJ2SIDE begins printing
  142. the "backs", or even pages.  Once these pages have been sent to the
  143. printer, you receive a prompt to prepare the printer to print the
  144. "fronts", or odd pages.  DO NOT REMOVE ANY PAGES FROM THE OUTPUT
  145. TRAY UNTIL THE PRINTING OF THE BACKS HAS FINISHED!!!
  146.  
  147. Once the printing stops, take the pages from the output tray and
  148. "spin" them 180 degrees.  Put them back in the input tray on the
  149. DeskJet.  This step puts the head of the page back into the printer,
  150. with the text just printed on the top of the page.  This sets the
  151. pages up to print the fronts.  The fronts are printed in reverse
  152. order, so that the first page of the first document appears on top
  153. of the pile of output when all documents have printed.
  154.  
  155. The best way to get used to the idea is to try it on a few small
  156. documents initially.  If you forget to spin the output, you will end
  157. up with "tumbled" output - you need to lift the page from bottom to
  158. top to read the back properly.  This is useful if you have special
  159. folders where pages are punched at the top.
  160.  
  161.  
  162.  
  163. DJ2SIDE Terminology
  164. ~~~~~~~~~~~~~~~~~~~
  165.  
  166. I had to adopt some standard terms in order to think about this
  167. program properly.  Here's an explanation of the terms:
  168.  
  169.  
  170. FRONT    Typically an odd-numbered page (since most documents start
  171.          at page 1).  The only time this is not true is in documents
  172.          that have a title page or table of contents, and are
  173.          automatically numbered by a word processor.
  174.  
  175.  
  176. BACK     Typically an even-numbered page.  You need to turn or lift
  177.          a page to look at the back.
  178.  
  179.  
  180.  
  181.  
  182.  
  183. DJ2SIDE Options
  184. ~~~~~~~~~~~~~~~
  185.  
  186. Start DJ2SIDE by typing  DJ2SIDE  and pressing Enter.  This will
  187. give you a brief description of the program.
  188.  
  189. Typing   DJ2SIDE ?  and pressing Enter will give a brief list of the
  190. options you can specify for DJ2SIDE.  This section discusses the
  191. options in more detail.
  192.  
  193. These options allow you to configure DJ2SIDE to most printing needs.
  194. Note that the options take effect for your entire session, so only
  195. print those files that require a given set of options.  You may
  196. enter the options in any order on the command line.
  197.  
  198.  
  199.    Option   Purpose
  200.    ------   --------------------------------------------------------
  201.    -ob      Print only the backs of the document.  The paper must be
  202.             placed correctly in the input tray for this to work
  203.             properly.  Again, experimentation is probably best.
  204.  
  205.    -of      Print only the fronts of the document.  The paper must be
  206.             placed correctly in the input tray for this to work
  207.             properly.  Again, experimentation is probably best.
  208.             This option is most useful when you notice that the top
  209.             page misfeeds as the fronts start printing.
  210.  
  211.    NOTE:    for these options, only the FIRST specified will be
  212.             used.
  213.  
  214.  
  215.    Option   Purpose
  216.    ------   --------------------------------------------------------
  217.    -bnn     Number of blanks to put at the start of odd numbered
  218.             pages (fronts) to increase the left margin for punching
  219.  
  220.             e.g. -b5 will shift the fronts of the pages 5 characters
  221.                  to the left.
  222.  
  223.    -c       Suppresses addition of carriage return at the end of the
  224.             line.  This will likely be more useful when I support
  225.             other printer types, but I added it during testing to
  226.             accommodate some special problems I encountered.
  227.  
  228.    -fnn     Number of footer lines to allow (default is 3)
  229.             This value is effective ONLY in documents that do not
  230.             have form feed characters already.
  231.  
  232.             e.g.  -f4 allows 4 lines at the bottom of each page
  233.  
  234.    -hnn     Number of header lines to allow (default is 3)
  235.             This value is effective ONLY in documents that do not
  236.             have form feed characters already.
  237.  
  238.             e.g.  -h4 allows 4 lines at the top of each page
  239.  
  240.  
  241. DJ2SIDE Options (cont'd)
  242. ~~~~~~~~~~~~~~~~~~~~~~~~
  243.  
  244.    Option   Purpose
  245.    ------   --------------------------------------------------------
  246.    -lnn     Page length in lines (default is 66)
  247.  
  248.    -mnn     Number of blanks to add to left margin on ALL pages.
  249.  
  250.             e.g.  -m5  add 5 spaces to the start of each line
  251.  
  252.             This option is useful for shareware documentation like
  253.             this file, that have a 70 character per line limit.
  254.             Using a  -m5  option will leave a 5 character left
  255.             margin on ALL pages.
  256.  
  257.    -n       DO NOT reverse the pages
  258.  
  259.    -pn      LPT port to use (1, 2 or 3) (default is 1)
  260.  
  261.             e.g.  -p2  sends output to LPT2:
  262.  
  263.    -txx     Type of printer.  Default is DeskJet.  Currently, this
  264.             is the only option recognized.  As more printers are
  265.             supported (I'm working on it), then this parameter will
  266.             be more useful.
  267.  
  268. Example:
  269. ~~~~~~~~
  270.  
  271. This document is formatted at 70 characters per line, with embedded
  272. formfeed characters.  You can print this out on both sides so that
  273. there is a 5 character margin on both sides by using the command
  274.  
  275.         dj2side -m5 dj2side.txt
  276.  
  277.  
  278. WARNING
  279. ~~~~~~~
  280.  
  281. DJ2SIDE does NOT do any printer setup!  You HAVE to put the printer
  282. into the proper mode BEFORE you start printing.  I intend to put 
  283. some controls into later versions to help this along, but for now, 
  284. SET THE DESKJET PRINTER UP FIRST!
  285.  
  286.  
  287.  
  288. DJ2SIDE REGISTRATION FORM
  289. ===========================
  290.  
  291. Registration Information (What do I get if I register!)
  292. ~~~~~~~~~~~~~~~~~~~~~~~~
  293.  
  294. All registered users of DJ2SIDE will receive one update with the
  295. most recent version of the program.  Subsequent updates are available
  296. for $3.00 shipping and handling on request.
  297.  
  298.  
  299.  
  300.  
  301. TO:                      FROM:
  302.  
  303. Warrick Wilson              Name: ___________________________________
  304. 98 Nipigon Street
  305. Kitchener, Ontario     (Company): ___________________________________
  306. Canada, N2B 3N7
  307. 519-571-1690             (Title): ___________________________________
  308.  
  309.                          Address: ___________________________________
  310.  
  311.                       City,State: ___________________________________
  312.                           (Prov.)
  313.  
  314.                        Telephone: ___________________________________
  315.  
  316.  
  317.  
  318. DJ2SIDE Price Schedule
  319. ~~~~~~~~~~~~~~~~~~~~~~
  320.  
  321. 1-9   copies  - $15 per copy
  322. 10-49 copies  - $12 per copy
  323. 50-99 copies  - $10 per copy
  324. 100+  copies  - One time fee of $1000
  325.  
  326.  
  327. Canadian Residents - please send Canadian Funds
  328. All Others         - prices are U.S. dollars
  329.  
  330.  
  331. I WOULD LIKE TO REGISTER:
  332.  
  333.    ____ copies of DJ2SIDE V1.0  X  $______  per copy      = $________
  334.  
  335.  
  336.  
  337.                                           TOTAL ENCLOSED = $
  338.                                                              ========
  339.  
  340.  
  341.  
  342. Signature: ____________________________________
  343.  
  344.  
  345.  
  346. Update Log
  347. ~~~~~~~~~~
  348.  
  349. Version 1.0 (released February 1993)
  350.    - initial release
  351.  
  352.  
  353. Planned Enhancements
  354. ~~~~~~~~~~~~~~~~~~~~
  355.  
  356. I have a list of possible enhancements, plus I'm always open to
  357. suggestions.  If you have any, drop me a line and let me know of
  358. your ideas.
  359.  
  360. - support double-sided printing on LaserJet and dot matrix printers
  361. - see if I can do the same thing under Windows (this may be a long
  362.   term project!)
  363. - include some formatting routines to reformat a document to fit the
  364.   user's margins and line widths
  365. - allow selective printing of a range of pages to recover from 
  366.   printer misfeeds
  367. - better support for monitoring printer status
  368. - printer control via command line options 
  369.   (draft mode, line width, etc.)
  370.